Node / meshtastic / Meshtastic-Android / files / specs / 006-kmp-project-structure / plan.md

Displaying Rendered • View raw • Download

Branch: T383838020-kmp-project-structure | Date: 2025-07-15 | Spec: T383838specs/006-kmp-project-structure/spec.md

Input: Feature specification from T383838specs/006-kmp-project-structure/spec.md

Migrate 27 KMP modules from legacy T383838android {} blocks inside T383838kotlin {} to the recommended T383838kotlin.androidLibrary {} top-level DSL. The project already runs AGP 9.2.1 and applies T383838com.android.kotlin.multiplatform.library via convention plugins — the primary work is DSL migration in individual module T383838build.gradle.kts files and hardening the convention plugin helper T383838configureKotlinMultiplatform() to absorb common settings (like T383838androidResources.enable = false and T383838withHostTest {}) so modules need fewer per-module overrides. Build verification at each step is critical.

Language/Version: Kotlin 2.3+ targeting JDK 21 (JDK 17 for published modules)

Primary Dependencies: AGP 9.2.1, Kotlin Multiplatform Gradle Plugin, T383838com.android.kotlin.multiplatform.library

Storage: N/A (build infrastructure only)

Testing: T383838./gradlew assembleDebug :desktop:packageUberJarForCurrentOS allTests for build verification

Target Platform: Android (API 26+) + Compose Desktop (JVM)

Project Type: Mobile app (KMP) — build infrastructure change

Performance Goals: Build time must not increase >5% (NFR-001)

Constraints: Configuration cache, isolated projects, parallel execution must remain functional (NFR-002)

Scale/Scope: 27 KMP modules across T383838core/ (19) and T383838feature/ (8), plus 4 convention plugin files in T383838build-logic/

• I. Kotlin Multiplatform Core: ✅ PASS — No source files are modified. All changes are to T383838build.gradle.kts configuration files and convention plugin Kotlin files in T383838build-logic/. Business logic in T383838commonMain is untouched. The migration moves Android target configuration from T383838kotlin { android {} } to T383838kotlin { androidLibrary {} } — a pure DSL change with identical semantics.

• II. Zero Lint Tolerance: ✅ PASS — Verification commands:

• T383838./gradlew spotlessApply spotlessCheck (formatting)

• T383838./gradlew detekt (static analysis)

• Convention plugin files in T383838build-logic/ are covered by the T383838:build-logic:convention:spotlessCheck and T383838:build-logic:convention:detekt tasks.

• III. Compose Multiplatform UI: ✅ N/A — No UI changes. This is a build infrastructure change only.

• IV. Privacy First: ✅ PASS — No runtime behavior changes. No PII exposure. T383838core/proto submodule not modified.

• V. Design Standards Compliance: ✅ N/A — No user-facing UI changes. Cross-Platform Spec: N/A — build infrastructure change.

• VI. Verify Before Push: ✅ — Local verification commands:

T282828

Te6edf3DESKTOP_ONLYTff7b72=Tffa657true ./gradlew :desktop:packageUberJarForCurrentOS

Post-push: T383838gh pr checks <PR> or T383838gh run list --branch 020-kmp-project-structure --limit 5

T282828

T282828

Structure Decision: Existing module structure is preserved. This change only modifies T383838build.gradle.kts files and convention plugin helpers. No directory restructuring.

│ No constitution violations. No complexity exceptions needed.